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New Goodies 


We have several new products available this month. There are 
Gescriptions inside this issue of the new Cross Reference 
program for the S-C Macro Assembler, and the new book “Apple ][ 
Circuit Description". Also, the long-awaited RCA 1802 Cross 
Assembler is now ready, at $32.50. 


Version 1.1 of the Macro Assembler is now ready to go! The 
upgrade from the current Version 1.0 will only cost you $12.50. 
That gets you //e, Videx, and STB 80-column support, 5 new 
directives and all the other new features described last month. 


DISASM and the //e 


Yesterday afternoon I received two phone call in less than 30 
minutes, both reporting that RAK-Ware's disassembler, DISASM, 
does not work on the Apple //e. The problem occurs when DISASM 
calls an odd entry into the monitor HOME routine. At several 
places in the routines to enter address information Bob Kovacs 
used SFC5A for a sort of combination VTAB and Clear-to-End-of- 
Page. Well, that won't work on a //e. The following patches 
change all the calls to SFC5A into S$FC58, or the standard HOME 
routine. This will change the behavior of the:program a 
little, making the screen clear between entries, rather than 
just tab down, but the program should now work. 


84C:58 94D:58 A79:58 
AD8:58 BBA: 58 BFB:58 


Patch DOS 3.3 for Fast LOAD and BLOAD......Bob Sander-Cederlof 


There must be at least a dozen products on the market now to 
speed up DOS 3.3: Diversi-DOS, David-DOS, The DOS Enhancer, 
QuickDOS, FastDOS, Hyper-DOS, et cetera. Some of these are 
unfortunately nat compatible with the everyday programs we like 
to use, such as the S-C Assembler, ES-CAPE, or our favorite 
word processor. And it can be quite difficult sometimes to 
determine the degree of compatibity. 


For the record, S&H Software's DOS Enhancer is completely 
compatible with the S-C Macro Assembler.’ David-DOS works wel] 
until you try to use the .TF directive. 


Most of the speed-up systems only improve the speed of LOAD, 
BLOAD, RUN, BRUN, SAVE, and BSAVE. Some also speed up booting 
into the language card. And two (Diversi-DOS and David-DOSs) 
speed up READing and WRITE-ing TEXT files, as well as offering 
a lot of minor enhancements in pursuit of more “user- 
friendliness", 


It seems that the more the speed-up system does, the more 
compatibility problems you can expect. After all, to add a 
feature you do have to change some code. And many programs on 
the market expect the DOS image to be un-modified so they can 
jump into DOS subroutines in strange unexpected places and make 
their own custom patches to the DOS image. 


Paul Schlyter (a subscriber in Sweden) sent me a small patch 
for DOS 3.3 early in April, 1982. Paul's patch speeds up only 
RUN, BRUN, LOAD and BLOAD, but it such a small patch that it 
will almost fit into the interstices (unused bytes) inside DOS. 
In fact, after I removed one bug and reorganized the code a 
little, I was able to fit it entirely within two unused areas: 

** SBA69-BA95 and S$BCDF-BCFF. I believe the result is completely 
compatible with all the programs I use around here, except for 
the ones that use their own modified and protected DOS. 


Paul‘s patch turns out to be functionally equivalent to the 
much longer patch proposed in HardCore Magazine's HyperDOS, but 
it leaves the INIT command intact. 

I ran some timing tests: 


LOAD 40 sectors’ standard 10 sec 
patched 3.5 sec 


BLOAD 37 sectors standard 11] sec 
patched 4 sec 


LOAD 132 sectors standard 32 seconds 
patched 7.5 seconds 


I didn't try measuring times, but I suspect that SAVE and BSAVE 
may be just a little faster with this patch installed (during 
the read-after-write phase). 


** Not true! See "New Version of DOS -- Patchers Beware". 
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S-—C Macro Assembler (the best there LS l) cccccccccccccccccccccvccec ec S80. 00 
Nsource code of S-C Assembler II, Version 4.0, on di8k......cceeeee+995.00 
Fully commented, easy to understand and modify to your own tastes. 
S-C Macro Assembler /// Corer cccccccccccecececrcececccccscecsccec ec SLO, 00 
Preliminary version. Call or write for details. 


S-C Cross Reference Utility Cec ccecccccccccccec cc cccccccccccceccce es S20-00 
S-C Cross Reference Utility with Complete Source Code........-+2.+«+$50.00 


\Vs-c word PLOCEEBOL cccccc ccc cece ccc sc ccccceccceseceecccccccccceccec co S902 00 
\ As is, with fully commented source code. Needs S-C Macro Assembler. 
Applesoft Source Code on DiBk .ccccccccccccccccccccccccccccecccccc ce 990.00 
Very heavily commented. Requires Applesoft and S-C Assembler. 
ES-CAPE: Extended S-C Applesoft Program Editor. ..ccccccccccccccsee $60.00 


AAL Quarterly DISKS. cecccccccveccccsccsccccccccsevccevccceces sCach $15.00 
Each disk contains all the source code from three issues of “Apple 
Assembly Line", to save you lots of typing and testing time. 


QD#1: Oct-Dec 1980 QD#2: Jan-Mar 1981 QD#3: Apr-Jun 1981 
QD#4: Jul-Sep 1981 QD#5: Oct-Dec 1981 QD#6: Jan-Mar 1982 
QD#7: Apr-Jun 1982 QD#8: Jul-Sep 1982 QD#9: Oct-Dec 1982 


QD#10: Jan-Mar 1983 


Double Precision Floating Point for AppleSOft....ccccccccccccccesee 990.00 
Provides 2l-digit precision for Applesoft programs. 
Includes sample Applesoft subroutines for standard math functions. 


FLASH! Integer BASIC Compiler (Laumer ReSearch) .ccccccccccccccccee $79.00 
Source Code for FLASH! Runtime Package. ..cccccccccccccccccccccccccee $39.00 
ull Screen Editor for S-C Macro Assembler (Laumer Research).......$49.00 


The Visible Computer: 6502 (Software Masters).......(reg. $50.00) $45.00 
Super Disk Copy III (Sensible Software) .............(reg. $30.00) $27.00 
Amper-Magic (Anthro-Digital) wccceccccccccccccccccces (LEGe $75.00) $67.50 
Amper-Magic Volume 2 (Anthro-Digital) ..cccccccccccee (LEG. $35.00) $30.00 
Quick-Trace (Anthro-Digital) .ccccccccccccvccceccccccce (LEG. $50.00) $45.00 


DISASM Dis-Assembler (RAK-WALE) wc cccccccccc cece ccc ccccccccescccce ec 930.00 


Blank Diskettes (with hub ringS)....ccccccceeceee package Of 20 for $50.00 
Small 3-ring binder with 10 vinyl disk pages and disks........+.++-$36.00 
Vinyl disk pages, 6*x8.5", hold one disk each...c.cceccceceeeeelO for $6.00 
Reload your own NEC PC-8023 ribbon cartridges...........each ribbon $5.00 
Reload your own NEC Spinwriter Multi-Strike Film cartridges....each $2.50 
Diskette Mailing ProtectOrS..ccccccccccccccscccccccceel0-99: 40 cents each 

100 or more: 25 cents each 
ZIF Game Socket EXteEndel ecccccccccccccccc ccc ccc cece cece cccccc cece ce 920200 
Ashby Shift-Key MOGccccccccccsccccccc ccc cc ccc ccc cece ccccccc cece ccc ce 915.00 
Lower -Case Display Encoder ROMeccccccccccccccccccccccccc ccc ccccec ee 925200 

Only Revision level 7 or later Apples. 


Books, BOOKS, BOOKS... ccccccccccccccccccceeeCOMpare Our discount prices! 


"The Apple ][{ Circuit Description", Gayler....eeeeees ($22.95) $21.00 
"Enhancing Your Apple II, vol. 1", Lancaster......... ($15.95) $15.00 
"Incredible Secret Money Machine", Lancaster......c.cee- ($7.95) $7.50 
"Micro Cookbook, vol. 1", Lancaster...cecceccececeeee ($15.95) $15.00 
"Beneath Apple DOS", Worth & Lechner....cccccccccceee ($19.95) $18.00 
"Bag of Tricks", Worth & Lechner, with diskette......($39.95) $36.00 
“Apple Graphics & Arcade Game Design", Stanton.......($19.95) $18.00 
“Assembly Lines: The Book", Roger Wagner..cccccceceee ($19.95) $18.00 
"What's Where in the Apple", Second Edition.........- ($24.95) $23.00 
“what's Where Guide" (updates first edition)........-- ($9.95) $9.00 
"6502 Assembly Language Programming", Leventhal......($16.99) $16.00 
, "6502 Subroutines", Leventhal .cccccccccccccccccccccce (812-99) $12.00 
"MICRO on the Apple--1", includes diskette.......eeee ($24.95) $23.00 
“MICRO on the Apple--2", includes diskette.......ee.e- ($24.95) $23.00 
"MICRO on the Apple--3", includes diskette........... ($24.95) $23.00 


Add $1 per book for US postage. 


*** S-C SOFTWARE, P. O. BOX 280300, Dallas, TX 75228 *#* 
ant (214) 324-2050 at 
**#* We take Master Charge, VISA and American Express *** 


Foreign orders add postage needed. 
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Since the S-C Assemblers use the LOAD command to process .IN 
directives, large assemblies with large included files will 
assemble about three times faster when you install this 
speed-up patch. 


The patch is really rather simple. But before examining the 
patch, let's review the normal flow inside DOS for LOADing and 
BLOADing. 


DOS is constructed in three layers: the outer layer accepts 
your commands from the keyboard or from your program. The 
inner layer, called RWTS, handles the intimate details of 
reading or writing a specified sector on a specified track. 
RWTS also does the raw disk initialization when you use the 
INIT command. The layer between commands and RWTS is called 
the File Manager (FM). 


The command layer calls FM to open, close, rename, lock, 
unlock, verify, or delete a file; to print a catalog; to 
initialize a disk; or to position within a file. There are 
also four kinds of calls for reading and writing files, to read 
Or write one byte or a range of bytes. 


When you use the RUN or LOAD command, the command layer calls 
FM to read the first two bytes. These bytes contain the length 
of your program. For Integer BASIC or S-C Assembler source 
files, the length is subtracted from HIMEM to get a loading 
address. The loading address for Applesoft programs is found 
in $67,68. Then FM is called to read a range of bytes of that 
length, to be stored starting at the loading address just 
determined. 


When you use the BRUN or BLOAD command, the first four bytes 
are read off the front of the file. The first two bytes are 
the loading address, and the next two are the length. (Of 
course, you can override the loading address with the "A" 
parameter after the file name.) 


After winding our way through the front end of FM, we finally 
get to this subroutine (where the range is read): 


1000 READ. RANGE 


AC96- 20 B5 Bl 1010 JSR DECR.TEST. LENGTH 

AC99- 20 A8 AC 1020 JSR READ. BYTE 

AC9C- 48 1030 PHA SAVE THE BYTE 
AC9D- 20 A2 Bl 1040 JSR GET.ADDRESS.INC 

ACAO- AO 00 1050 LDY #0 

ACA2- 68 1060 PLA GET THE BYTE 
ACA3- 91 42 1070 STA ($42) ,Y STORE IN 
BUFFER 

ACA5- 4C 96 AC 1080 JMP READ. RANGE 


The subroutine DECR.TEST.LENGTH breaks out of this loop when 
the range has been completely read. The READ.BYTE subroutine 
picks bytes out of the DOS buffer, and reads a sector into that 
buffer when the buffer is empty. 
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RENT RE 
BEFORE YOU BUY 


from our 


SOFTWARE 
RENTAL LIBRARY 


popular software available for just 
20-25% * of Manufacturers’ Retail Price 
e Eliminate the risk—rent first! 
e 100% of rental fee applies toward purchase 
e All purchases are 20% Off of Manufacturer’s 
Suggested List 
e Rentals are for 7-days (plus 3 days grace for return 
shipping) 
e No Membership Fees 
Now currently available for: 


: ZORK WC: 


—_ 
a 


_} WILIMASNTIOA 


sd 


DEADLINE _] STAR RAIDERS (> CENTIPEDE | 


e 
ms 
= 
3 
5 3 
yr | 
rm 
Zz 
=| 
ct 
> 
AQ 
3 
4 


“} HdVu¥9S ‘Sdd CL) TWNOISS3IOUd USILIVANIZYIS _) +08 YVIOVNVW 31d TF 193dN3d VIVO 


Apple IBM, PC Standard CP/M 

Eagle TRS-80 I Xerox 820 
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REMEMBER, THESE ARE NOT DEMOS, BUT ORIGINAL 
UNRESTRICTED SOFTWARE PROGRAMS 


(complete with manuals in original manufacturers’ packages) 
To Immediately Order, or for more information: 


UNITED COMPUTER CORP Toll Free CALL 1-800 992-7777 
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To understand the speed-up patch, break the reading process 
into three parts: the first sector, the last sector, and all 
the in-between sectors. We will let the loop shown above 
handle the first sector and possibly the last sector, and read 
the in-between sectors using a faster method. Short files with 
only one or two data sectors will not have any in-between 
sectors, and so there will be no improvement in speed. 


First we need to read the rest of the first sector of the file. 
The first two or four bytes were already read to get address 
and length information. We can let the loop shown above do 
that job. But we need a way to break into the loop when it is 
our turn. Let's patch the JMP on the last line to jump to our 
patch. 


Our patch will get control after the loop above has read and 
stored a byte of data. At that time our patch can look at the 
current file position in S$B5E6; if S$B5E6 is non-zero, then 
there are still bytes in the DOS buffer. As long as there are 
bytes in the DOS buffer, we will branch back to $AC96 and let 
FM handle the bytes in its normal way. 


Once the first sector has been read and stored, a byte at a 
time, $B5E6 will have a zero value. MThen our patch can look at 
the remaining length. If the remainging length is at least one 
whole sector, we can read it faster. If not, FM can read the 
last partial sector in its normal fashion. 


To read a sector faster, we bypass the DOS buffer. We can 
temporarily patch the actual destination address where the 
sector must go into the RWTS call block. RWTS can put the 
entire sector directly into its final destination, rather than 
into the DOS buffer to be later moved by the rather slow loop 
above, 


The extra time saved by eliminating the middle man will save an 
entire revolution of the drive to get the next sector (if it is 
in the same track, and they usually are). A 40 sector file 
laid out sequentially on three tracks will save 38 revolutions 
of the disk. The disk spins at 5 revolutions per second, 80 we 
will save a hair over 7 seconds. (If the file is not laid out 
sequentially, the savings will be less.) 


The bigger the file, the bigger the percentage improvement. We 
can save 3 seconds per track. It normally takes FM about 18 
revolutions to read a track; with our patch, a track can be 
read in about 3 revolutions. We save 15 revolutions or 3 
seconds on each full track. That is, a full track can be read 
in .6 seconds instead of 3.6 seconds. The rest of the time 
required to read the file is spent moving the head from track 
to track, and reading the catalog and VTOC sectors, 


If all 16 sectors of a track are to be read, and if the sectors 
were allocated the normal DOS 3.3 way, I think this is the way 
it happens with my patch installed: 
F E D Cc B A 9 8 7 6 5 4 3 2 ] 0 
123 456789ABCDEFO 
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The bottom line of numbers shows the physical sector numbers, 
As you move across the page from left to right, you simulate 
the disk read head. It may take up to a full revolution of the 


disk 
pick 


before sector F appears, but once it does we proceed to 
off approximately every other sector as they come by. The 


top line of numbers shows the DOS 3.3 logical sector numbers. 
Logical sector E is actually physical sector 2, and so on. So 
it takes two full revolutions, plus two more sectors, to read 
all 16. 


If you are trying to figure out where the rest of the time is 
used, keep in mind that DOS first reads the VTOC (track 17, 
sector 0); then the first catalog sector (track 17, sector 15); 
if the file specified is not in the first catalog sector, it 
reads another; and so on. If the file is far down in the 
catalog, it might have to read all 15 catalog sectors to find 
the file. Then the track/sector list is read; it is usually in 
sector 15 of the same track containing the first 15 sectors of 


data. 


On the other hand, as the disk fills up the sectors get 


splattered all over the disk. 


Here 


is the patch code, arranged so that it squeezes into those 


two interstices I mentioned earlier: 


MUNIUIUIOW OC 
HHQQANKS 
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fo oho clo clos 
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oO 
~ 
a 


Apple 


1000 SS wewmeeme ee ewomeawseeemoeewwewoeeoceeaane 
1010 ® §.FAST LOAD. 
1020 ® 
1030 * FAST "LOAD*® AND ®BLOAD* 
1050 # INSTALLED IN UNUSED AREAS IN DOS 3.3: 
ogo ® B46 9-$BAg5 43 BYTES FREE 3-3 
1970 . BCDF-$BCFF 33 BYTES FREE 
1990 READ. RANGE .EQ AC 96 
1100 READ.NEXT.SECTOR -EQ $BO0 
1110 END.OF.DATA.ERROR .EOQ B36F 
1120 RANGE.LENGTH -EQ $B5C1,C2 
1130 RANGE. ADDRESS .EQ B5C3,C8 
1140 BUFFER.ADDRESS -EQ $B5CB,;CCc 
1190 SECTOR .COUNT EQ $B5E4,E5 
1 0 BYTE. OFFSET EQ $B5E6 
1150 OR $BA6Q 
1190 -TF B.PATCH1 
AD E6 B5 1210 PATCH1 LDA BYTE.OFFSET | LAST BYTE OF 
AD 2 BS 4e50 EDA RANGE LERGTHO! «= WHOLE Se cTOR L 
. + EFT? 
FO 1F isko BEQ GO.READ.RANGE NO. 
A CB B5 1250 LDA BUFFER.ADDRESS SAVE BUFFER ADDRESS 
AD CC BS 1270 LDA BUFFER.ADDRESS+1 
AD C3 B5 1290 LDA RANGE. ADDRESS READ DIRECTLY 
8D cB B5 1300 STA BUFFER. ADDRESS INTO RANGE 
AD Ch BS 1319 LDA RANGE. ADDRESS+1 
D CC B5 20 STA BUFFER. ADDRESS+1 
1 #0 READ.LOOP 
20 B6 BO 0 JSR READ .NEXT. SECTOR 
4C DF BC 1370 JMP PATCH2 
\C 6F B3 F 0 1 JMP END.OF.DATA.ERROR 
1 80 GO.READ.RANGE 
4C 96 AC 1410 . JMP READ.RANGE 
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Vi 30 ~OR SBCDE 
tee ; ~-TF B.PATCH2 
BCDF- EE E4 B5 1460 PATCH2 INC SECTOR. COUNT 
BCE2- DO o2 1179 BNE 
BCE4- EE E5 B5 1480 INC SECTOR. COUNT+1 
BCE7T- EE C4 B5 1490 «1 INC RANGE. ADDRESS+1 NEXT PAGE 
BCEA= EE CC B5 1500 INC BUFFER. ADDRESS+1 
PCED- CE C2 B5 1510 DEC RANGE. LENGTH+1 
BCFO- DO OB 1520 BNE . 
BCF2- 68 1236 PLA RESTORE BUFFER 
a oe 8D CC B5 1540 STA BUFFER. ADDRESS+1 
BCF6=- 68 1550 PLA 
BCF7- &D CB B5 1560 STA BUFFER.ADDRESS 
BCFA= 4C 96 AC 1248 JMP READ.RANGE ONE BYTE AT A TIME 
BCFD- 4C 87 BA 1590 .2 JMP READ.LOOP 
1600 #&--------~---- 


To install the patches, you need to BLOAD PATCH] and BLOAD 
PATCH2. Then patch locations SACA6-7 to 69 BA, to change the 
JMP READ.RANGE instruction to a JMP PATCH]. Note that you must 
BLOAD the patches before changing $ACA6-7. If you change 
SACA6-7 first, the system will crash as soon as you try to 
execute a BLOAD. 


Here is an Applesoft program (which you could append to your 
HELLO program) to poke the patches into DOS. 


20000 
20010 
20020 
20030 
20040 
20100 


20110 


20120 
20130 


REM INSTALL FAST DOS LOAD AND BLOAD PATCHES 


READ N: IF N = O THEN’ END 

READ A 

FOR I = 1 TO Ns: READ P: POKE A,P:A = A + 1: NEXT 
GOTO 20010 


DATA 44,47721,173,230,181,208,36,173,194,181, 
240,31,173,203,181,72,173,204,181,72,173,195, 
181,141,203,181,173,196,181,141,204,181,32, 
182,176,176,3,76,223,188,76,111,179,76,150,172 
DATA 33,48351,238,228,181,208,3,238,229,181, 
238,196,181,238,204,181,206,194,181,208,11, 
104,141,204,181,104,141,203,181,76,150,172, 


76,135,186 
DATA 2,44198,105,186 
DATA 0 


Paul mentioned he was working on an equally simple patch to 


speed up SAVE and BSAVE, but I haven't 


heard any more from him 


on that subject. 


FLASH! Compiler note: 


The FLASH! Integer Basic Compiler was recently reviewed by 


PEELINGS magazine and received an A+. 


It is currently the 


highest rated Integer compiler (the competition is rated only 


A). 
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The price? 


Just $79.00 ($70 less than the competition)! 


FASTDRAW 1.1 


A software package from CASTLE DESIGNS which provides enhanced 
Hi-Resolution Graphics instructions for use in Applesoft Basic 
programs. For example .... 


&DRAW,1 Erases, moves and re-draws an entire array 

of shapes with a single instruction. 
&HPLOT,1 Erases, moves and re-plots an array of points. 
&HGR,c Performs a hi-speed screen erase to any color. 


Plotting rate exceeds 4,000 points per second. 


Other FASTDRAW 1.1 instructions provide scrolling, as well as 
drawing or plotting without erasing. 
CASTLE DESIGNS FASTDRAW 1.1 .......+. $29.95 


This software may be used with the APPLIED ENGINEERING A/D 

BOARD to acquire and plot analog data. The A/D BOARD will 

acquire 8 channels of data with 8-bit resolution, and is very 

easy to use. Simply use a PEEK statement to read the data. 
APPLIED ENGINEERING A/D BOARD $129.00 


To acquire data with real-time accuracy, use the APPLIED 
ENGINEERING TIMEMASTER real time clock board in combination 
with the A/D BOARD and the FASTDRAW 1.1 software. The 
TIMEMASTER will provide timing for data acquisition as often 
@s once per millisecond. For example, 200 data points can be 
acquired and plotted in 250 milliseconds. The TIMEMASTER has 
battery backup and an on-board timer which can measure time 
intervals of up to 48 days to a resolution of one millisecond. 
APPLIED ENGINEERING TIMEMASTER ......... $129.00 


Included on the FASTDRAW 1.1 diskette are several programs 
which demonstrate its various uses and a utility which merges 
two shape tables. Requires Applesoft and DOS 3.3, and an 
APPLE II, II+, or IIe with 48K Ran. 


Texas Residents Add 5% Sales Tax (Hardware Only). 
Add $10.00 If Outside U.S.A. 


Order any of the above items from APPLIED ENGINEERING, P.O. 
BOX 470301, DALLAS, TEXAS 75247 ; Phone (214) 492-2027 


Or order FASTDRAW 1.1 from CASTLE DESIGNS, 2717 TEAKWOOD, 
PLANO, TEXAS 75075 
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An "ORG" Macro for’ Self-Aligning Code......Bob Sander-Cederlof 


Roger Johnson (Minnesota) called a week or so ago with a plea 
for an easy way to make program segments align themselves 
automatically on page boundaries. He was writing a system to 
be burned into EPROM and run on another computer; it would be 
easier to debug in the target machine if subroutines and data 
blocks began on even page boundaries. There was ample room, so 
the wasted bytes between routines didn't bother him. 


Of course, the .OR directive in the S-C Macro Assembler can 
easily change the origin whenever you wish, but it also changes 
the target address (.TA directive) or closes any open target 
file (.TF directive). Therefore a different approach is 
required, 


Bill Morgan and Mike Laumer described how to do this in these 
pages a few months back, using the .BS directive to reserve 
enough bytes to reach the next page boundary. But with the 
help of a simple macro, we can not only make it easier to make 
self-aligning code: we can also make it generate error 
messages if the origin we try to set involves backing up over a 
longer-than-expected predecessor. | 


Here is the macro definition, and a few lines demonstrating how 
to call the macro: 


1000 -MA ORG 

1010 eDO *>)1 

1020 ti! ERROR: ORG ]1 RANGE CROSSED !1! 
1030 » ELSE 

1040 -BS j1-* 

1050 FIN 

1060 . EM 

L070 Bem m mn rn rn nnn nnn nnn nner nnn nnn= 
1080 -OR $800 

1090 SAMPLE LDA $1234 

1100 RTS 

1110 >ORG $900 

1120 STA $1234 

1130 RTS 

1140 >ORG $980 


1150 DATA -DA #1,#2,#3 


Line 1110 calls the ORG macro with a parameter of "$900". This 
means that everywhere you find "J1" in the macro definition, 
the assembler will see "$900". The conditional (.DO) on line 
1010 will read *.DO *>$900". Since * equals $804 at this 
point, it is not greater than $900. Therefore the condition is 
false, and the lines following line 1010 will be skipped up to 
line 1030 where there is an ".ELSE". The lines after 1030 
through the ".FIN" on line 1050 will be assembled. Line 1040 
will be assembled as ".BS $900-*", which will bump the location 
up to $900. 
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Apple Peripherals Are All We Make 


That’s Why We're So Good At It! 


The TIMEMASTER 
Finally, a clock that does it ALL! 


@ Designed in 1983 using I.C. technologies that simply did not exist 
when most other Apple clocks were designed. 

@ Just plug it in and your programs can read the year, month, date, day, 

and time — down to 1 millisecond! 

Powerful 2K ROM driver — No clock could be easier to use. 

Full emulation of most other clocks, including Mountain Hardware’s 

Appleclock (but you'll like the TIMEMASTER mode better). 

@ Compatible with all of Apple's languages, CP/M and PASCAL software 
on disk. 

@ Eight software controlled interrupts so you can execute two programs 
at the same time. 

@ On board timer lets you time any interval up to 48 days long down to 
the nearest millisecond. 

The TIMEMASTER includes a disk with some really fantastic time 

oriented programs (over 25) plus a DOS dater so it will automatically add 

the date when disk files are created or modified. This disk is over a 

$200.00 value alone — we give the software others sell. All software 

packages for business, data base management and communications are 

made to read the TIMEMASTER. 


If you want the most powerful and the easiest to use clock for your Apple, 


you want a TIMEMASTER. PRICE $129.00 


Super Music Synthesizer 


Complete 16 voice music synthesizer on one card. Just plug it into your 
Apple, connect the audio cable (supplied) to your stereo, boot the disk 
supplied and you are ready to input and play songs. 

It's easy to program music with our compose software. You will start 
right away at inputting your favorite songs. The Hi-Res screen shows 
what you have entered in standard sheet music format. 

We give you lots of software. In addition to Compose and Play 
programs, the disk is filled with songs ready to play. 

Easy to program in Basic to generate complex sound effects. 

Four white noise generators which are great for sound effects. 

Plays music in true stereo as well as true discrete quadraphonic. 
Full envelope control. 

Will play songs written for ALF synthesizer (ALF software wil! not take 
advantage of all the features of this board. Their software sounds the 
same in our synthesizer.) 

Automatic shutoff on power-up or if reset is pushed. 

Many many more features. 


PRICE $159.00 


Z-80 PLUS! 


@ TOTALLY compatible with ALL CP/M software. 
@ Executes the full Z-80 and 8080 instruction set. 
@ Fully compatible with microsoft disks (no pre-boot required). 


@ An on-card PROM eliminates many I.C.’s for a cooler, less power 
consuming board. (We use the Z-80A at a fast 3.58 MHZ) 

@ Does EVERYTHING the other Z-80 boards do, plus Z-80 interrupts. 

@ All new 1983 design incorporates the latest in I.C. technologies. 

@ Complete documentation included. (User must furnish software) 


The 2-80 PLUS turns your Apple into a CP/M based computer. This 
means you can access the largest body of software in existence. Two 
computers in one and the advantages of both. all at an unbelievably low 
price. 


PRICE $139.00 


Analog to Digital Converter 


@ 8 Channels 

@ 8 Bit Resolution 

@ On Board Memory 

@ Fast Conversion (.078 ms per 
channel) 


@ Eliminates the Need to Wait for 
A/D Conversion (just PEEK at data) 

@ A/D Process Totally Transparent 
to Apple (looks like memory) 


The analog to digital conversion takes place on a continuous, channel 
sequencing basis. Data is automatically transferred to on board memory 
at the end of each conversion. No A/D converter could be easier to use. 


OurA/D board comes standard with 0, 10V full scale inputs. These inputs 
can be changed by the user to 0, -10V, or -5V, +5¥V or other ranges as 
needed. 


Information on temperature sensors is given in manual. 

The user connector has +12 and -12 volts on it so you can power your 
sensors. 
Accuracy 0.3% 


Input Resistance 20K Ohms Typ 


A few applications may include monitoring and control of @ flow 
@ temperature @ humidity @ wind speed @ wind direction e light 
intensity @ pressure @ RPM @ storage oscilloscope @ soil moisture 
and many more. 


PRICE $129.00 


Digital Input/Output Board 


@ Provides 8 buffered outputs to a standard 16 pin socket for standard 
dip ribbon cable connection. 


@ Power-up reset assures that all outputs are off when your Apple is 
turned on. 


@ Features 8 inputs that can be driven from TTL logic or any 5 volt source. 


» 


@ Your inputs can be anything from high speed logic to simple switches. 

@ Very simple to program, just PEEK at the data. 

@ Now, on one card, you can have 8 digital outputs and 8 digital inputs 
each with its own connector. The super input/output board is your 
best choice for any control application. 


PRICE $62.00 


Our boards are far superior to most of the consumer electronics made today. Al I.C.’s are in high quality sockets with mil-spec. components used throughout. P.C. boards are 
glass-epoxy with gold contacts. Made in America to be the best in the world. All products work in APPLE Ile, It and Il + 


Applied Engineering's products are fully tested with complete documentation and available for immediate delivery. All products are guaranteed with a no hassle two year 
warranty. > 
. Send Check or Money Order to: 


APPLIED ENGINEERING 
P.O. Box 470301 
Dallas, TX 75247 


Call (214) 492-2027 
7am to 11pm 7 days a week 
MasterCard & Visa Welcome 


All Orders Shipped Same Day 
Texas Residents Add 5% Sales Tax 
Add $10.00 If Outside U.S.A. 
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Here's how the above example assembles: 


1000 .MA ORG 
1010 .DO *>]1 
1020 1!!! ERROR: ORG }1 RANGE CROSSED !!! 
1030 . ELSE 
1040 .BS ]1-* 
1050 .PIN 
1060 EM 
1070 *------------------------~-------+ 
1080 .OR $800 
0800- AD 34 12 1090 SAMPLE LDA $1234 
0803- 60 1100 RTS 
0804- 1110 >ORG $900 
0000> .DO *>$900 
0000> . ELSE 
0804- 0000> .BS $900-* 
0000> FIN 
0900- 8D 34 12 1120 STA $1234 
0903- 60 1130 RTS 
0904- 1140 >ORG $980 
0000> .DO *>$980 
0000> . ELSE 
0904- 0000> .BS $980-* 
0000> FIN 
0980- 01 02 03 1150 DATA .DA #1,#2,#3 


If we had written line 1110 as ">ORG $800" the condition on 
line 1010 would be true, causing line 1020 to be assembled. 


Line 1020 is illegal syntax for the assembler, so it will be 
listed after an error message. The *J1" will be filled in to 
make the line list like this: 


*** BAD OPCODE ERROR 
1110> 1!! ERROR: ORG $800 RANGE CROSSED !1! 


That will occur during pass one of the assembly, so no code 
will be generated. The error message will be the only output. 


New S-C Cross Reference Utility.....cccccccccccccsseoMike Laumer 


At last a Cross Reference Utility is available for the S-C 
Assemblers that is fully compatible with the latest releases of 
the S-C Macro Assembler. It handles all the new directives, 
shows macro calls, and can even give an optional cross 
reference on the opcodes! It only takes a few seconds to cross 
reference even a huge file and begin the listing! It is even 
faster than the Macro Assembler in processing the source lines. 


The Cross Reference Utility also can optionally print a 
paginated source file listing before printing the cross 
reference. That way you can be certain that you have a program 
listing with the same line numbers shown in the cross reference 
listing. 


only $20.00 for the object code 
What other 


The price is reasonable: 
version and $50.00 for both source and object code. 
company sells source code to their utilities! 
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DATE PROCESSING MODULES 
BY BROOKE BOERING 
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-OR $800 


VAGABONDO ENTERPRISES 
1300 E ALGONQUIN - 36 
SCHAUMBURG IL - 60195 


(312) 397-8705 


DEAR BOB: FIRE ORGAN 

OVER THE PAST FEW YEARS I HAVE ALWAYS ENJOYED READING AAL AND 
FREQUENTLY FOUND USEFUL INFORMATION. I APPRECIATE THIS TYPE OF 
PUBLICATION AND HOPE THAT YOU WILL BE ABLE TO CONTINUE ITS PUBLICATION 
INDEFINITELY. IN MY OPINION, THIS IS THE ’BEDROCK’ SUPPORT LEVEL FOR 
PROGRAMMING THE APPLE. 


TI HAVE INCLUDED A CONTRIBUTION FOR AAL THAT I HAVE USED WITH A 
STATISTICAL ANALYSIS SYSTEM (NEVER MARKETED). IT’S FOR ’ DATE’ 
PROCESSING (NOT ’DATA’), AND AN OVERVIEW IS PRINTED AND ENCLOSED 
HEREWITH. THE DISK HAS BOTH THE SOURCE CODE AND A "BRUNABLE’ COPY OF 
THE OVERVIEW. 


AGAIN, THANKS FOR A TRULY USEFUL PUBLICATION. 
MY BEST, 
BROOKE (W BOERING) 
PS. BILL MORGAN! $“ CATALOG ARRANGER WAS PARTICULARLY REVEALING OF THIS 
PART OF DOS. PLEASE THANK HIM FOR ME IF CONVENIENT. 
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RAM/ROM PROGRAM DEVELOPMENT BOARD 

Plugs into any Apple slot. Holds one user-supplied 2Xx8 memory chip. Use a 61146 type RAN chip for 
program development or just extra memory. Plugin a programmed 2716 EPROM to keep your favorite routines 
‘on-line’. Maps into $(n00-SCaFF and $C800-SCFFF memory space. Instructions & circuit diagram provided. 


The “MIRROR? ;: Firmware for Apple-Cat $27.00 
Communications ROM plugs directly into Novation’s modem card. Three basic modes: Dumb Terminal, Remote 
Console & Programmable Modem. Added features inciudes Printer buffer, Pulse or Tone dialing, true 
dialtone detection, audible ring detect and ring-back option. Directly supports many 80-column boards 
(even while printing) and Apple’s Comm card commands. (Apple-Cat Hardware differences prevent 100/ 
interchangability with Comm card.) Includes Hayes-to-AppleCat register equivalances for software 
conversion. Telephone Software Connection (213-516-9430) has several programs which suppert the ‘MIRROR’. 


The “PERFORMER’ : Smarts For Your Printer $49.00 
Get the most from your smart printer by adding intelligence to your ‘dumb’ interface card. The PERFORMER 
Board plugs into any Apple slot for immediate access (no programs to find and load). Easily select 
printer fonts and many other features via a user-friendly menu. Replaces manual printer set-up. No need 
to remember ESC commands. Also provides TEXT and GRAPHICS screen dumps. Compatible with Apple, Tymac, 
Epson, Microtek and similar ’duab’ Centronics type parallel I/F boards. Specify printer: | EPSON MX80 
W/Graftrax-80, EPSON MX100, EPSON MX80/MX100 W/Graftrax Plus, NEC 8023A, C.Itoh 8510 (ProWriter), OKI 
Microline 82A/83A W/OKIGRAPH. (OK1 Bonus: The PERFORMER Generates ENHANCED and DOUBLE STRIKE Fonts) 


Avoid A $3.00 Shipping/Handl ing Charge By Mailing Full Payment With Order 
RAK -~-WA RE 
41 Ralph Road 
West Orange NJ 07052 


#aaat SAY YOU SAW IT IN ‘APPLE ASSEMBLY LINE’! s8e82 
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NEW from Laumer Research 
The S-C Macro Assembler Screen Editor. 


Powerful Screen Editor for assembler files, co-resident with 
the S-C Macro Assembler allowing screen editing when you want 
it and S-C Macro Assembler editing too. Loads in the unused 
4K bank of memory in a 16K Language Card. 


Includes SYSGEN program for configuring standard 40 column 
Apple, 80 column VIDEX, or 80 column STB80 video drivers. 
Ajustable tabs, margins, horizontal and vertical scrolling, 
lines to 248 columns, and much more... 


SOURCE code included. (Lets you learn about screen editors 
and configure for other brands of 80 column boards) 


Based on a popular TI 990 editor for software developers. 
NOTE: this is not a word processor editor. Organized just for 
computer languages. If you work with assembly programs of 100 
lines or more, then a Screen Editor is a MUST! 


Requires 64K APPLE II with Language card and S-C Macro 
Assembler Language Card Version 1.0. 


Price $49.00 from LAUMER RESEARCH 
1832 SCHOOL RD. 
CARROLLTON, TX 75006 


Master Card and Visa accepted (send Name, card number and exp. 
date). Foreign orders add $3.00 shipping (US funds only). 
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The Apple ][ Circuit Description: A Review.........Bill Morgan 


"Have you ever wanted to know the detailed circuit operation of 
your Apple ][{ computer? Perhaps you were designing a 
peripheral or making a modification. Maybe you were repairing 
an Apple. You may have just been curious about how it works." 


That's the first paragraph of a new book called The Apple ][ 
Circuit Description, by Winston D. Gayler. If the answer to 
that question is "yes", you need to look at this book. Cirtuit 
Description contains about 160 pages of text describing the 
operation of every component on the Apple's motherboard and 
keyboard. There are also 44 large fold-out pages of easy-to- 
read block diagrams, schematics, timing diagrams, and waveform 
drawings. The enlarged, readable schematics alone will be 
worth the price of the book to some users! 


One of the first things Mr. Gayler handles is identifying the 
various revisions of the Apple ][, from the original Rev. 0 
through last year's RFI treated motherboard, Rev. D. The body 
of the book covers that last version, while an appendix goes 
into the differences in all earlier revisions, and the diagrams 
show all revisions. The very latest thing, the Apple //e, is 
not mentioned, since that's a radical departure from all 
others. 


The book is intended for engineers, technicians, students, and 
serious hobbyists. The descriptions, schematics, timing 
diagrams, and waveform drawings can be an invaluable help in 
designing peripherals and modifications, troubleshooting, 
studying practical circuit design, and just understanding how 
your Apple works. 


Each chapter has two sections, Overview, and Detailed Circuit 
Description. You can cruise the Overview sections to get an 
idea of what's going on in each piece of your Apple, or you can 
sit down with the Detailed Circuit Description, the schematics, 
your Apple, and your TTL Data Book, and figure out each and 
every signal in the computer. 


Here is a chapter-by-chapter summary: 
1. Introduction and overview of the book. 


2. Block-diagram discussion of the whole computer's structure, 
introducing concepts like “address multiplexer" and "video 
address generator". Apple's unique patented power supply is 
also covered here. 


3. Clocks: the master oscillator, clock generator, and the 
horizontal portion of the video address generator. Clocks 
are especially important in the Apple due to their interplay 
with the video circuitry. 


4. The vertical portion of the video address generator and the 
sync, blanking, and color burst signals. 


5. RAM memory, the 4116's and their addressing, as well as the 
shared access scheme for the video memory. 
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QuicKTRACE 


relocatable program traces and displays the actual machine operations, while it is running 
without interfering with those operations. Look at these FEATURES: 


Single-Step mode displays the last instruction, 
next instruction, registers, flags, stack contents, 
and six user-definable memory locations. 


Trace mode gives a running display of the Single- 
Step information and can be made to stop upon 
encountering any of nine user-definable 
conditions. 


Background mode permits tracing with no display 
until it is desired. Debugged routines run at near 
normal speed until one of the stopping cond: 
Itions is met, which causes the program to return 
to Single-Step. 


QUICK TRACE allows changes fo the stack, 
registers, stopping conditions, addresses to be 
displayed, and output destinations for all this 
information. All this can be done in Single-Step 
mode while running. 


Two optional display formats can show a sequence 
of operations at once. Usually, the information 
is given in four lines at the bottom of the screen. 


QUICK TRACE is completely transparent to the 
program being traced. It will not interfere with 
the stack, program, or I/O. 


QUICK TRACE is relocatable to any free part of 
memory. Its output can be sent to any slot or to 
the screen. 


QUICK TRACE is completely compatible with 
programs using Applesoft and Integer BASICs, 
graphics, and DOS. (Time dependent DOS 
operations can be bypassed.) It will display the 
graphics on the screen while QUICK TRACE Is 
alive. 


QUICK TRACE is a beautiful way to show the 


incredibly complex sequence of operations that 
a computer goes through in executing a program 


Quick TRACE $50 


Is a trademark of Anthro-Digital, Inc. 
Copyright © 1981 
Written by John Rogers 


See these programs at participating Computerland and other 
fine computer stores. 


Anthro - Digital Software, Inc. 
P.O. Box 1385 Pittsfield, MA 01202 
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6. The 6502 processor and its internal cycles, including read 
cycles, write cycles, RAM and ROM cycles, I/O and keyboard 
cycles, interrupts, and DMA (direct memory access). 


7. On-board I/O, devices, including cassette I/O, the game port, 
the speaker, and the current two-piece keyboard. 


8. Video generator hardware, how it creates TEXT, LORES, and 
HIRES displays under software control. : 


Appendices: 


A. Introduction to standard video signal techniques, for those 
of us who know even less about video than about digital. 


B. Various revisions of the Apple motherboard. The main text 
of the book describes the RFI, Rev. D board. This appendix 
covers the differences in all earlier boards, as well as the 
old one-piece keyboard. 


C. Schematics. Pages and pages of enlarged diagrams of all 
versions of the motherboard and keyboards. 


In the Introduction, Gayler says that the reader should be 
familiar with TTL (gates, flip-flops, shift registers, and 
multiplexers) and should have a basic knowledge of micro- 
processor and microcomputer architecture. Well, I have a very 
basic knowledge of architectures, and almost no familiarity 
with TTL details. This book looks like it will be a great tool 
for learning about TTL, because I will be able to relate what 
the data books say about a chip to a knowledge of what that 
chip is doing in my very own Apple. 


One thing I would like to see is a sort of cross-reference by 
motherboard coordinate. It would be nice to be able to ask the 
book "What is the function of that 74LS20 at location D2?" As 
it is, I had to look through several foldouts for a chip symbol 
labelled "D2". It is a NAND gate in “Fig. C-2. Clock Generator 
(all revisions)" Since it's part of a clock circuit, it must 
be covered in chapter 3. Several minutes of poking around in 
chapter 3 tells me that chip is part of one of the Apple's most 
unique features! Every 65th CPU cycle is slightly stretched 
(1117 us vs. 978 us) to maintain sync with the color signals, 
and D2 is responsible for triggering that stretch. 


That last paragraph started out to describe a shortcoming of 
the book, and turned into yet another example of the kind of 
great information contained in The Apple ][ Circuit 
Description. If you're doing any hardware work with the Apple, 
Or if you want to learn more about what's going on in there, 
you need this book. 


The Apple ]{ Circuit Description, by Winston D. Gayler. 
Published by Howard W. Sams. 8 1/2 by 11 comb binding. 172 
pp. text, 44 fold-out diagrams. Shipping weight 3 lbs. List 
price is $22.95, our price will be $21 + shipping ($2 domestic, 
$12 overseas). 
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New Version of DOS -- Patchers Beware 


When Apple released the //e they apparently also slipped in a 
Slightly revised version of DOS, called DOS 3.3e (or 3.3c. 
Reports differ.) The following information about the changes 
is from Tom Weishaar's DOStalk column in the April issue of 
Softalk. 


The boot routine now throws a couple of new soft switches 
($COOC and S$COOE) and stores S$FF in location S$4FB. These steps 
turn off the //e's 80-column mode during boot-up. 


A routine at $B33]1 that calculates position in a random access 
file is now simplified. 


Now for the biggie: Another APPEND fix! (attempted) According 
to Weishaar, they eliminated a bug that occurred maybe once in 
10,000 tries by introducing a new bug that bites once every 256 
calls. Tom says that the most reliable method is to use the 
old DOS 3.3 and POKE -18851,0 before each APPEND. 


The most significant thing about the APPEND change is where 
they put the patch: at S$BA69! That used to be empty space and 
a popular place to install patches. No more! As a matter of 
fact, Bob's Fast Load patch in this issue goes into that area, 
and therefore should not be used with DOS 3.3e. 


This means that //e users should be especially careful about 
installing published patches into DOS 3.3e, and all of us 
should quit using $BA69-BA95 for patches that will be 
distributed. 


It’s here at last 


PRAWM 


Please send me a PRAWM board 
in the following configuration: 


Configuration Qty Unit Price Total 


2K bytes ___ _—s«d1224..95 

(8K byte non-volatile memory for Apple II) OK M4 Ie —— doen —— 
° Write like a RAM BK bytes 249.95 —___ 
e Data retention like a ROM include $2.00/ board shipping & 

f andling 

e No battery backup required Arfount enclosed } 
© Off the shelf delivery SHIP TO 
© 1 year limited warranty —-— 
e Enable/disable under program control — 


without (CFFF) 

e Data alterable 1 byte at a time 

¢ No EPROM programmer necessary 
e No ultraviolet lights to erase 

e Auto start on power-up 
e 
s 
e 


Please send: cert. check 
money order 
personal check 
VISA or MasterCard 
accepted 


Operates in any “Apple II," peripheral slot 
On board firmware for block transfers 
Permanent storage of new commands, 
subroutines, utilities. 
e Multiple configurations: 2K, 4K, 6K. 8K bytes 
e User-expandable to 8K bytes 
¢ Compatible with Apple II+ and Apple Ile 
1 Apple Il is a registered trademark 
of Apple Computer. Cupertino. CA 


To order call 503-654-0611 or fill out order form: 
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To: Advanced Peripheral Ent.. Inc. 
2617 S.E. Swain Ave. 
Milwaukie:.OR 97222 

SHIP VIA: 


COD orders accepted 


PATCHER: A General-Purpose Patch Installer.........-Bill Morgan 


My favorite new feature in Version 1.1 of the S-C Macro 
Assembler is the .PH directive. When Bob first described the 
new directive to me, I didn't quite see how to use it. Then he 
showed me a program like this one, and now I don't see how I 
did without it! 


The directive .PH <expr> in an assembly causes the origin to be 
reset to <expr>, but the code continues to be stored in 
successive bytes of the same area as before. The result is 
much like the following lines all rolled into one: 


2000 LABEL 
2010 -OR SOMEWHERE. ELSE 
2020 ~TA LABEL 


The difference is that the above lines would close an open 
Target File, whereas .PH SOMEWHERE.ELSE continues to direct 
code into the same file. The end of an offset block is marked 
with a .EP directive, that restores the origin to match the 
target address. 


With this feature is so easy to assemble one program to create 
some patches and move them into place, all in one step. 
Anyway, here's the general purpose PATCHER, with some dummy 
code to show it off. 


DISASM (Version 2.2) $30.00 
Use DISASN, the intelligent disasseabler, to convert 6502 machine code into meaningful, symbolic source. 
It creates a text file which is directly compatable with DOS ToolKit, LISA and S-C (both 4.0 & Macro) 
Assemblers. Use DISASM to customize existing machine language programs to your om needs or just to see 
how they work. DISASH handles sultiple data tables, invalid op codes and displaced object code (the 
program being disassembled doesn’t have to reside in the memory space in which it executes). DISASM lets 
you even substitute MEANINGFUL labels of your own choice (100 commonly used Monitor & Pg Zero names 
included in Source form to get you rolling). The address-based cross reference table option results in 
either a selective or complete cross reference (to either screen or printer). Page Zero and External 
references are listed separately in numeric order. The cross reference table provides as much insight 
into the inner workings of machine language programs as the disassembly itself. ODISASH has proven to be 
an invaluable aid for both the novice and expert alike. 


Utilities For Your S-C Assembler (4.0) 


SC.65SR: A Global Search and Replace Eliminates Tediows Manual Renaming Of Labels.....cesscoeesss$20.00 
SC.XREF: A Linenumber-Based Global Cross Reference Table For Complete Source Documentation......20.00 
SC.TAB: Tabulates Source Files Into Neat, Readable Form. Encourages Fast, Free-Format Entry....$15.00 
SC UTILITY PAK: Includes All Three Utilities Described Above (You Save $10.00)....csscesscsescs.$49.00 


All of the above programs are written entriely in machine language and are provided 
on a standard 3.3 DOS formatted diskette. 


fwoid A $3.00 Shipping/Handl ing Charge By Mailing Full Payment With Order 
RAK -WA RE 
41 Ralph Road 
West Orange NJ 07052 


#atne SAY YOU SAW IT IN “APPLE ASSEMBLY LINE’! #a8e# 
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memory and disks. You can search forward 


he Inspector puts you in total control of both 
and backwards, edit, read nibbles, 


to set all your utilities together in one place — 
inside your Apple. The Inspector comes on an 


map disk space. dump the screen 
to a printer, examine every secret 
of your Apple. Use The Inspector 


automatic loading on boot. Either way, it stays at 
to repair blown disks, undelete 


Eprom that simply plugs into the D8 socket, or on 
your fingertips, ready to call without disturbing 
your current program. 
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P2. LENGTH - BQ #-~PATCH2 


1000- 1410 P1.ORIGIN .EQ $1000 
2000- 1420 P2.ORIGIN .EQ $2000 
3000- 1430 P3.ORIGIN .FQ $3000 
1450 ® OTHER .EQUATES HERE 
1460 
1470 Brew ne ee eee eee eee 
1480 PATCHES 
0334- 03 00 10 1500 .DA #P1.LENGTH,P1.ORIGIN 
1510 .PH P1.ORIGIN 
1520 
1330 pATCHI 
1540 ® PATCH1 CODE HERE 
1000- 4C 00 20 1550 JMP PATCH2 
0003- 1570 P1.LENGTH .EQ §-PATCH1 
1580 .EP 
1590 #-----~--------------------------- 
033A- 03 00 20 1600 .DA #P2.LENGTH,P2.ORIGIN 
1610 .PH P2.ORIGIN 
1620 
16 30 PATCH2 
1640 ® PATCH2 CODE HERE 
2000- 4C 00 30 1650 JMP PATCH3 
1660 
1670 
1680 
1690 
0340- 03 00 30 1700 .DA #P3.LENGTH, P3.ORIGIN 
1710 .PH P3.ORIGI 
1720 
1730 PATCH3 
17ho * PATCH3 | CODE HERE 
3000- 4c 00 10 1750 JMP~ PATCH! 
0003- 1770 P3.LENGTH .EQ *-PATCH3 
1780 ~EP 
1790 Samnn nnn nn 
0346- 00 1800 DA #0 END OF PATCHES 
1810 #--------------~ ~~ eee ne 
SYMBOL TABLE 
032B- GET.BYTE 0002- PATCH 
0120331 1000- PATCH! 
0003- P1.LENGTH 2000- PATCH2 
1000- P1.ORIGIN 3000- PATCH3 
300G- POLORIGIN Bi cOaDAT Oe ZO31A, 0 y 
- ° ° = e = e =0 25 0 =0 2A 
0003- P3.LENGTH 06334- PATCHES + 20320325, 3 
3000- P3.ORIGIN 0000- PNTR 


Notice that the object code columns show the bytes to be all 
over pages 3, 10, 20, and 30. The labels in the Symbol Table 
show the same thing. But, if you look around in memory, all 
this is in page 3. Once you type $300G, the JMP instructions 
will be moved to their true destinations. 


Bob's DOS Fast Load patches elsewhere in this issue are an 
ideal example of how to use PATCHER. Here's all it takes: 


1> Make the following changes to lines 1410-1430 of PATCHER 
1410 P1.ORIGIN .EQ SBA69 
1420 P2.ORIGIN .EQ S$BCDF 
1430 P3.ORIGIN .EQ SACAF 


2> Substitute Lines 1090-1160 of Fast Load for Line 1450 of 
PATCHER. 
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3> Substitute Lines 1210-1410 of Fast Load for Lines 
1530-1550 of PATCHER. 


4> Substitute Lines 1460-1590 of Fast Load for Lines 
1630-1650 of PATCHER. 


5> And substitute the following line for Lines 1740-1750 of 
PATCHER: 
~-DA PATCH] 


Now you have a BRUNnable program which will quickly install the 
Fast Load patches into DOS. And if you want to add other DOS 
patches to the same program, just tack them in between lines 
1790 & 1800. 


If you want to patch something running in a RAM card, like the 
Macro Assembler, you just need to add the following lines: 


1082 LDA $C083 
1084 LDA $C083 
1315 .4 LDA $C080 
1320 RTS 


And that's how I expect to handle patches from now on. Hope 
you find it useful! 


Teamed up inside \ 


~ INTRODUCING Now Tue Inspector: 
our Apple, Watson . 
yds nee, features 


AS AN ASSISTANT 
that give you complete i 


access to everything you ever 
wanted to know about memory 


om or disk versions are always al 
your fingertips. Watson (requires The 
spec. $49.95 The Inspecr. 


toll-free, or return the coupon, 


1-800-835-2246 


> 
and disks. Recover blown disks, Co the inspector @ 35995 -—«*222 So. Riverside Plaza 
fix catalog entries, display and delete Cec of mony ore mecloced  BnteaBAAn 


control characters, repair bad data files even 


| 

| 

| 

I 

| 

on Gisks with non-normal DOS. Search for ward and Apple 11) hope + tmaeger Card] 16K Ram Card [1] l 
| 
| 
| 
| 
| 
| 


Apple is « registered trademark of Apple Computer. Inc 2 


backwards in memory, edit in HEX, ASCII, NEGATIVE ASCII = £ 
and LOWER CASE. Scan dinks forward and backwards, follow files 3 
for ward and backwards in track/sector list on either 33: or 16-sector 
Ginka Dachout sectors on Track Bit Map, reconstruct VTOC, find and display all § address 
Was b/ Sector tiets ifuplay ma al sect ors peed on dish. read Nibbles track-by-track. f 
er mbis af » iL baveree an ers, verify compare Gnpiay 

Uforensoe r hy dou he DOS 10 inp Mreoerel charamere ie foe tod tom me ” 
“ Wee . ihottm s om vithia BASIC. There's more but we're running ont of spare 7 

ee ~ 
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More about the PRAWM Board....cccccccccveeseeBOb Sander-Cederlof 


Advanced Peripheral Enterprises has introduced their PRAWM 
board, and is advertising elsewhere in this issue of AAL. 


The PRAWM board contains from 2K to 8K of EEPROM. Data or 
programs can be written into the memory on the card, just as 
though it were RAM. Yet the memory is non-volatile, as in ROM, 
PROM, Or EPROM. If you turn of your Apple, remove the card, 
ship it around the world...when you plug it back in the bytes 
will still be there! 


EEPROM stands for “Electrically Eraseable PROM"; circuitry on 
the card allows you to individually write any bytes you wish, 
without erasing the rest of the memory. You do not need a 
separate EPROM programmer and ultraviolet EPROM eraser. There 
are no batteries either. The card is priced about the same as 
an EPROM card, but you save a lot of money on accessories. You 
will also save a lot of time, since you don't have to erase for 
30-60 minutes, program chips for 5-20 minutes, and plug and 
unplug countless times. (You can program the entire 8K on a 
fully loaded PRAWM board in less than 25 seconds!) 


The PRAWM card contains from 1 to 4 EEPROM chips, providing 
from 2K to 8K bytes. Each chip maps into the address space 
from $C800-SCFFF, and is accessed by switching in one chip at a 
time. On-board firmware makes it easy to move blocks of data 
between any chip and RAM. 


By installing a jumper strap, you can even have the program 
stored in the first 2K chip automatically start up when you 
turn on your Apple, before or instead of booting a floppy. 
Just think of the possibilities: set up special commands, 
execute security procedures, power fail recovery, "boot" a 
mini-DOS of your own creation from PRAWM, eliminate the need 
for disk drives in turn-key monitoring applications...! Other 
strap options allow you to write-protect the board and to 
disable the SCFFF de-select function. 


If you do a lot of development work involving EPROMs now, I 
think this card would be a big help. See Advanced Peripheral 
Enterprises' ad for price and ordering information. 


Apple Assembly Line is published monthly by S-C SOFTWARE CORPORATION, P.O. Box 
280300, Dallas, Texas 75228. Phone (214) 324-2050. Subscription rate is $15 
per year in the USA, sent Bulk Mail; add $3 for First Class postage in USA, 
Canada, and Mexico; add $13 postage for other countries. Back issues are 
available for $1.50 each (other countries add $1 per back issue for postage). 


All material herein is copyrighted by S-C SOFTWARE CORPORATION, all rights 
reserved. (Apple is a registered trademark of Apple Computer, Inc.) 
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